Add agentic refresh Phase 0 controls#110
Open
juliamuiruri4 wants to merge 2 commits into
Open
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Introduces Phase 0 “agentic refresh” governance controls and validation tooling to keep automation report-only, pin gh-aw authoring support, and enforce deterministic guardrails (allowlists, contracts, ruleset templates, pinned actions) before any write automation is enabled.
Changes:
- Add Phase 0 validation scripts for refresh configuration and local Markdown link integrity.
- Add GitHub Actions workflows to validate content + agentic-workflow authoring inputs, and pin referenced actions by full commit SHA.
- Add refresh governance artifacts (capabilities, quests allowlists, token policy, ruleset templates, labels, contracts, CODEOWNERS) and supporting repo configuration files.
Show a summary per file
| File | Description |
|---|---|
| scripts/validate-refresh-config.mjs | Deterministic validator for Phase 0 refresh governance, policies, allowlists, and pinned-actions enforcement. |
| scripts/validate-content-links.mjs | Repository-wide Markdown local-link and anchor validation for docs hygiene. |
| .vscode/settings.json | Enables Copilot for Markdown in VS Code workspace settings. |
| .github/workflows/validate-content.yml | Adds CI job to validate refresh config, link integrity, and MkDocs build. |
| .github/workflows/validate-agentic-workflows.yml | Adds CI job to validate gh-aw compilation consistency and pinned actions. |
| .github/workflows/deploy.yml | Pins deploy workflow actions to full commit SHAs. |
| .github/workflows/copilot-setup-steps.yml | Adds Copilot Agent setup workflow that installs pinned gh-aw CLI. |
| .github/skills/agentic-workflows/SKILL.md | Adds skill definition for routing gh-aw authoring/debug/upgrade requests. |
| .github/mcp.json | Configures MCP server for gh-aw (gh aw mcp-server). |
| .github/dependabot.yml | Adds monthly Dependabot updates for pip dependencies. |
| .github/CODEOWNERS | Establishes code ownership for Phase 0 boundary files. |
| .github/agents/agentic-workflows.md | Adds dispatcher agent description and operational guidance for gh-aw usage. |
| .github/agentic-refresh/tooling.json | Pins gh-aw version and related setup action identifiers. |
| .github/agentic-refresh/stack-policy.md | Defines allowed stack/branch structure and refresh operational constraints. |
| .github/agentic-refresh/rulesets/main.json | Template ruleset for main protections (disabled by default). |
| .github/agentic-refresh/rulesets/human-merge.json | Template ruleset for human-only merges (disabled by default). |
| .github/agentic-refresh/report-contract.md | Defines required structure and evidentiary standards for weekly reports. |
| .github/agentic-refresh/README.md | Documents Phase 0 controls and local validation commands. |
| .github/agentic-refresh/quests.json | Defines quest allowlists, owned paths, governance limits, and branch patterns. |
| .github/agentic-refresh/lifecycle-policy.md | Defines lifecycle evidence requirements for findings. |
| .github/agentic-refresh/labels.json | Declares required refresh-state and quest labels. |
| .github/agentic-refresh/governance.md | Documents Phase 0 boundaries, token model constraints, and activation sequence. |
| .github/agentic-refresh/github-token.json | Machine-readable token permission model and forbidden operations list. |
| .github/agentic-refresh/capability-matrix.md | Human-readable summary of capability gating and activation sequence. |
| .github/agentic-refresh/capabilities.json | Current capability state with explicit blockers and audit evidence. |
| .github/agentic-refresh/audience-style-guide.md | Defines audience assumptions and documentation style constraints. |
| .github/agentic-refresh/asset-policy.md | Defines asset creation/revision constraints and required metadata. |
| .gitattributes | Marks compiled workflow lockfiles as generated and forces merge=ours. |
Review details
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 28/28 changed files
- Comments generated: 3
- Review effort level: Low
Comment on lines
+30
to
+43
| function stripCodeFences(content) { | ||
| let insideFence = false; | ||
|
|
||
| return content | ||
| .split("\n") | ||
| .map((line) => { | ||
| if (/^\s*(```|~~~)/.test(line)) { | ||
| insideFence = !insideFence; | ||
| return ""; | ||
| } | ||
| return insideFence ? "" : line; | ||
| }) | ||
| .join("\n"); | ||
| } |
Comment on lines
+459
to
+463
| check( | ||
| JSON.stringify(quest.ownedPaths) === | ||
| JSON.stringify(expectedOwnedPaths.get(quest.id)), | ||
| `${prefix} owned paths must exactly match the reviewed path allowlist`, | ||
| ); |
Comment on lines
+464
to
+468
| check( | ||
| JSON.stringify(quest.externalReports) === | ||
| JSON.stringify(expectedExternalReports.get(quest.id)), | ||
| `${prefix} external reports must exactly match the reviewed report-only allowlist`, | ||
| ); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
gh-awv0.77.5GITHUB_TOKENwith no stored App, PAT, OAuth, or private-key credentialAzure-Samples/JavaScript-AI-Buildathon; external CodeTour repositories are permanent report-only evidence sources with manual maintainer handoffGITHUB_TOKEN-generated events generally do not trigger workflowsSafety boundary
This change does not add quest agents, discovery schedules, issue creation, content-writing workflows, stack execution, or merge automation. Buildathon remains
report-onlyuntil every bounded token, dispatch, Copilot, ruleset, and approval capability is proven andwriteAutomationAllowedis explicitly enabled. External repositories have no automated write-enablement path under this strategy.Actions required after merge
main, activate disabled main ruleset19622585and the human-only merge ruleset.copilot-requests: write, AI-credit budget, Buildathon issue/refresh/**branch/PR safe outputs, explicit required-check dispatch, and explicit Copilot review for the current head SHA.No GitHub App or credential secret needs to be created.